跳到主要内容

创建静态 PIX QR 码

静态 QR 码适用于不知道付款方身份、付款时间和付款人数量的支付场景。基本上,它由经过编码的密钥(可选含金额)组成,因为只引用密钥,所以可以被多次支付。

请求

ENDPOINT
/account/ACCOUNT_KEY/alias/ALIAS_KEY/qrcode
MÉTODO
POST
请求体:静态 QR 码
{
"request_control_key": "8a923886-afce-4116-ac1f-69bdffcf8da9",
"qr_code_type": "static",
"pix_key": "joaosilva@gmail.com",
"amount": 10.25,
}

请求体参数

字段类型描述字符数
request_control_key *string请求的唯一 UUID4 标识符。-
qr_code_type *stringQR 码类型。"static"
pix_key *string代表交易目标账户的 PIX 密钥。-
amountfloatQR 码金额。如未提供,由付款方填写。

响应

STATUS
201 Created
响应体:创建静态 QR 码
{
"request_control_key": "037b46b1-0c67-4c0d-aac3-1e395dfdcb10",
"base_64_payload": "<BASE64 DA URI DO PIX COPIA E COLA>"
}
字段类型描述字符数
request_control_key *string请求的唯一 UUID4 标识符。-
base_64_payload *stringBase64 格式的 QR 码支付 URL。-
STATUS
400
响应体
{
"title": "Bad Request",
"description": "Invalid payload for QR Code creation.",
"translation": "Payload inválido para a criação de QR Code.",
"code": "QRI000003"
}